机器人令牌

授权您的机器人

每个机器人在创建时都会被赋予一个唯一的认证令牌。这个令牌看起来像

40e9a501895dd29dac511d6ae35911f0487eeee52fb185718deb6c6862bcf7fb

我们在接下来的文档中使用 <token> 作为替代。

发起请求

所有对 Bot API 的查询都必须通过 HTTPS 服务，并且需要以这种形式呈现:

https://a1.fanbook.mobi/api/bot/bot<token>/METHOD_NAME

如下面这相列子:

https://a1.fanbook.mobi/api/bot/bot40e9a501895dd29dac511d6ae35911f0487eeee52fb185718deb6c6862bcf7fb/getMe

我们支持 POST HTTP 方法。Bot API 支持在请求中传递参数的方式：

• application/json（除上传文件外）
• multipart/form-data(用于上传文件)

响应包含一个 JSON 对象，它总是有一个布尔字段 'ok'，也可能有一个可选的字符串字段 'description'，是一个易读的结果描述。

如果 'ok' 等于真，说明请求成功，可以在 'result' 字段中找到查询结果。如果请求不成功，'ok' 等于 false，错误将在 'description' 中解释。一个整型 'error_code' 字段也会被返回，但它的内容可能会在将来发生变化。有些错误可能还有一个可选的'参数'字段，类型为 ResponseParameters，它可以帮助自动处理错误。

• Bot API 中的所有方法都不区分大小写。
• 所有的查询都必须使用 UTF-8。